---
title: "Transition Delay"
description: "Utilities for controlling the delay of CSS transitions."
---

import plugin from 'tailwindcss/lib/plugins/transitionDelay'
import { Variants } from '@/components/Variants'
import { Disabling } from '@/components/Disabling'

export const classes = { plugin }

## Usage

Use the `delay-{amount}` utilities to control an element's transition-delay.

```html amber
<template preview>
  <div class="flex justify-around items-center">
    <button class="transition delay-150 duration-300 ease-in-out transform hover:scale-125 bg-amber-600 text-white font-semibold px-6 py-3 rounded-md">
      Hover me
    </button>
    <button class="transition delay-300 duration-300 ease-in-out transform hover:scale-125 bg-amber-600 text-white font-semibold px-6 py-3 rounded-md">
      Hover me
    </button>
    <button class="transition delay-700 duration-300 ease-in-out transform hover:scale-125 bg-amber-600 text-white font-semibold px-6 py-3 rounded-md">
      Hover me
    </button>
  </div>
</template>

<button class="transition **delay-150** duration-300 ease-in-out ...">Hover me</button>
<button class="transition **delay-300** duration-300 ease-in-out ...">Hover me</button>
<button class="transition **delay-700** duration-300 ease-in-out ...">Hover me</button>
```

## Responsive

To control an element's transition-delay at a specific breakpoint, add a `{screen}:` prefix to any existing transition-delay utility. For example, use `md:delay-500` to apply the `delay-500` utility at only medium screen sizes and above.

For more information about Tailwind's responsive design features, check out the [Responsive Design](/docs/responsive-design) documentation.

## Customizing

### Delay values

By default, Tailwind provides eight general purpose transition-delay utilities. You change, add, or remove these by customizing the `transitionDelay` section of your Tailwind theme config.

```diff-js
  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        transitionDelay: {
+         '0': '0ms',
+         '2000': '2000ms',
        }
      }
    }
  }
```

Learn more about customizing the default theme in the [theme customization documentation](/docs/theme#customizing-the-default-theme).

### Variants

<Variants plugin="transitionDelay" name="transition-delay" />

### Disabling

<Disabling plugin="transitionDelay" name="transition-delay" />
